home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / pmnsmerge.z / pmnsmerge
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  132 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNSSSSMMMMEEEERRRRGGGGEEEE((((1111))))                                                      PPPPMMMMNNNNSSSSMMMMEEEERRRRGGGGEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmnnnnssssmmmmeeeerrrrggggeeee - merge multiple versions of a Performance Co-Pilot PMNS
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      $$$$PPPPCCCCPPPP____BBBBIIIINNNNAAAADDDDMMMM____DDDDIIIIRRRR////ppppmmmmnnnnssssmmmmeeeerrrrggggeeee [----aaaaddddffffvvvv] _i_n_f_i_l_e [...]  _o_u_t_f_i_l_e
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppmmmmnnnnssssmmmmeeeerrrrggggeeee merges multiple instances of a Performance Metrics Name Space
  16.      (PMNS), as used by the components of the Performance Co-Pilot (PCP).
  17.  
  18.      Each _i_n_f_i_l_e argument names a file that includes the root of a PMNS, of
  19.      the form
  20.  
  21.                root {
  22.                    /* arbitrary stuff */
  23.                }
  25.      The order in which the _i_n_f_i_l_e files are processed is determined by the
  26.      presence or absence of embedded control lines of the form #define
  27.      _DATESTAMP YYYYMMDD
  28.  
  29.      Files without a control line are processed first and in the order they
  30.      appear on the command line.  The other files are then processed in order
  31.      of ascending _DATESTAMP.
  32.  
  33.      The ----aaaa option suppresses the argument re-ordering and processes all files
  34.      in the order they appear on the command line.
  35.  
  36.      The merging proceeds by matching names in PMNS, only those nnnneeeewwww names in
  37.      each PMNS are considered, and these are added after any existing metrics
  38.      with the longest possible matching prefix in their names.  For example,
  39.      merging these two input PMNS
  40.  
  41.                root {                    root {
  42.                                              surprise  1:1:3
  43.                    mine       1:1:1          mine      1:1:1
  44.                    foo                       foo
  45.                                              yawn
  46.                    yours      1:1:2
  47.                }                         }
  48.                foo {                     foo {
  49.                    fumble     1:2:1
  50.                                              mumble    1:2:3
  51.                    stumble    1:2:2          stumble   1:2:2
  52.                }                         }
  53.                                          yawn {
  54.                                              sleepy    1:3:1
  55.                                          }
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. PPPPMMMMNNNNSSSSMMMMEEEERRRRGGGGEEEE((((1111))))                                                      PPPPMMMMNNNNSSSSMMMMEEEERRRRGGGGEEEE((((1111))))
  70.  
  71.  
  72.  
  73.      Produces the resulting PMNS in _o_u_t.
  74.  
  75.                root {
  76.                    mine      1:1:1
  77.                    foo
  78.                    yours     1:1:2
  79.                    surprise  1:1:3
  80.                    yawn
  81.                }
  82.                foo {
  83.                    fumble    1:2:1
  84.                    stumble   1:2:2
  85.                    mumble    1:2:3
  86.                }
  87.                yawn {
  88.                    sleepy    1:3:1
  89.                }
  90.  
  91.      To avoid accidental over-writing of PMNS files, _o_u_t_f_i_l_e is expected to
  92.      not exist when ppppmmmmnnnnssssmmmmeeeerrrrggggeeee starts.  The ----ffff option forces the removal of
  93.      _o_u_t_f_i_l_e (if it exists), before the check is made.
  94.  
  95.      The ----dddd option allows the resultant PMNS to optionally contain duplicate
  96.      PMIDs with different names in the PMNS.  By default this condition is
  97.      considered an error.
  98.  
  99.      The ----vvvv option produces one line of diagnostic output as each _i_n_f_i_l_e is
  100.      processed.
  101.  
  102.      Once all of the merging has been completed, ppppmmmmnnnnssssmmmmeeeerrrrggggeeee will attempt to
  103.      compile the resultant namespace using ppppmmmmnnnnssssccccoooommmmpppp(1) - if this fails for any
  104.      reason, _o_u_t_f_i_l_e will still be created, but ppppmmmmnnnnssssmmmmeeeerrrrggggeeee will report the
  105.      problem and exit with non-zero status.
  106.  
  107. CCCCAAAAVVVVEEEEAAAATTTT
  108.      Once the writing of the new _o_u_t_f_i_l_e file has begun, the signals SIGINT,
  109.      SIGHUP and SIGTERM will be ignored to protect the integrity of the new
  110.      file.
  111.  
  112. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  113.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  114.      file and directory names used by PCP.  On each installation, the file
  115.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  116.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  117.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  118.  
  119. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  120.      ppppmmmmnnnnssssaaaadddddddd(1), ppppmmmmnnnnssssccccoooommmmpppp(1), ppppmmmmnnnnssssddddeeeellll(1), ppppccccpppp....ccccoooonnnnffff(4), ppppccccpppp....eeeennnnvvvv(4) and ppppmmmmnnnnssss(4).
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.